MENUBAR Toolbar Program Users manual Release 1.00 February 28, 1992 Copyright (c) 1992 by MRL 1200 Stonehurst Huntsville, Alabama 35801 All Rights Reserved This file provides the information needed to utilize the shareware distribution version of the MENUBAR program. MENUBAR is a copyrighted product of MRL and all rights are reserved. Any and all usage must be in accordance with terms discussed in section III of this documentation. No usage other than for evaluation is permitted without registration. User feedback including comments/questions are welcome. Please address your comments to MRL via Compuserve electronic mail at user id [73637,737] or via mail to 1200 Stonehurst, Huntsville, AL., 35801. Restrictions and Warranties The software described herein is furnished under a license agreement. The software may be used or copied only in accordance with the terms of the applicable agreement. The purchaser may make one copy of the software for backup purposes. Unregistered copies of MENUBAR are for evaluation purposes only, and may be distributed through normal shareware channels. Please distribute these evaluation copies to other bulletin boards and users. MENUBAR may be uploaded to and downloaded from commercial systems such as CompuServe, the Source, and BIX, as long as there is no charge for the product itself. Those copying, sharing, and/or electronically transmitting this product are required not to delete or modify the copyright notice and restrictive notices from the program or documentation. Any distribution of MENUBAR must include all files contained in the packed format. Commercial vendors and distributors of "public domain" or user-supported software libraries may distribute copies of MENUBAR unless notified by MRL to cease distribution of the product. Only nominal fees associated with copying and handling (not to exceed $5 US) may be charged by anyone providing unregistered copies. MENUBAR may not be utilized or distributed as a promotion for any commercial venture. Information in this document is subject to change without notice and does not represent a commitment on the part of MRL. To use MENUBAR, you need the following: IBM PC (or compatible)-286 with 1 Mbyte. Microsoft Windows (version 3.0 or later) MS-DOS/PC-DOS (version 3.0 or a later version required by your version of Microsoft Windows) Use of this product for any period of time constitutes your acceptance of this agreement and subjects you to its contents. EXCEPT AS PROVIDED IN PART III OF THIS MANUAL, MRL DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, WITH RESPECT TO THE PRODUCT. SHOULD THE PROGRAM PROVE DEFECTIVE, THE PURCHASER ASSUMES THE RISK OF PAYING THE ENTIRE COST OF ALL NECESSARY SERVICING, REPAIR, OR CORRECTION AND ANY INCIDENTAL OR CONSEQUENTIAL DAMAGES. IN NO EVENT WILL MRL BE LIABLE FOR ANY DAMAGES WHATSOEVER (INCLUDING WITHOUT LIMITATION DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION AND THE LIKE) ARISING OUT OF THE USE OR THE INABILITY TO USE THIS PRODUCT. I. CONCEPT MENUBAR may be utilized with MS Windows to customize the user environment by addition of menubars (or toolbars) that specify a user selected icon/bitmap file and associate this file with an executable programs. MENUBAR provides a capability to define toolbar controls that augment existing execution methods or create a complete desktop environment based on the users own preferences. II. Specification of Options This section describes how the user creates and selects the MENUBAR capabilities. Three command line functions are described in the following sections, with the additional sections describing the dialogue interaction necessary to edit or create a menubar and mouse/key usage. 1.0 Execution of an existing menubar definition. The user may execute a previously defined menubar definition by providing the definition name as the first parameter of the command line. Note that each menubar definition is stored as a separate MSDOS file. If the user does not specify the MSDOS filename extension, MENUBAR creates this with the extension .mbr. The command to execute an existing definition is menubar xxx, where xxx is the menubar definition name. xxx must conform to the filename portion of the MSDOS naming conventions. When utilizing Program Manager for execution, it is recommended that the pathname be included as part of both the program name and definition name. For example "c:\menubar\menubar.exe c:\data\menu1" would execute the MENUBAR program from directory c:\menubar and use the menu1 definition form the MSDOS file c:\data\menu1.mbr. The default pathname for bitmap/icon files is the pathname provided for the definition file. To utilize a menubar as part of windows startup, the win.ini file should be modified as follows: 1) Add to Extensions section mbr=xxx\menubar.exe yyy\^.mbr where xxx is the MENUBAR program directory and yyy is the directory containing the .mbr files. 2) Add to Windows section run=xxxx.mbr where xxxx is the desired menubar name. MENUBAR is not configured to replace the Windows program manager. 2.0 Creating a new menu definition. The user creates a new definition file by entering the menubar command without any parameters. A Message Box will confirm that this was the intended action, and then a data dialogue will be provided for entry of the definition name. The detailed definition dialogues (see section 4.0) are then provided for specification of the characteristics. 3.0 Editing an existing definition The user may edit an existing definition by specifying the -E parameter followed by the definition name. For example "menubar -E menu1" would edit the menu1.mbr file in the current directory. The detailed dialogues (see section 4.0) are displayed to allow for changing the current characteristics. 4.0 Detailed characteristics This Section describes three detailed dialogues for definition of the menubar. The Menubar dialogue provides for definition of all parameters and selection of individual command sets for modification or deletion. The command set dialogue allows for specification of the bitmap/icon file, the command and associated parameters. The file open dialogue allows for file selection. 4.1 Menubar dialogue The fields on this dialogue allow for complete definition of a single menubar. They include size, position, number of items per row, and close options. Individual commands activate the command set dialogue or operate on command sets. 4.1.1 ROW Entry to this edit box is the row location in pixels of the upper left hand corner of the menubar. 4.1.2 COLUMN Entry to this edit box is the column location in pixels of the upper left hand corner of the menubar. 4.1.3 HEIGHT Entry to this edit box is the height in pixels of the menubar. This is a function of the number of rows of bitmaps/icons planned and the size of the icons. Bitmaps are sized within a part of the menubar. Icons are truncated if the size is insufficient. This size should be specified as (desired height of bitmap/icon+1)*(Number of rows)+9. If this field is omitted, MENUBAR calculates the height based on an individual bitmap/icon size of 32 pixels. 4.1.4 WIDTH This edit box is the width in pixels of the menubar. This is a function of the number of bitmaps/icons planned for a row and the size of the icons. Bitmaps are sized within a part of the menubar. Icons are truncated if the size is insufficient. This size should be specified as (desired width of bitmap/icon+1)*(Number of items per row)+9. If this field is omitted, MENUBAR calculates the width based on an individual bitmap/icon size of 32 pixels. 4.1.5 Items per row This edit box is the is the number of bitmaps/icons to place on each row. This is a required field. Multiple rows are created when the number of command sets exceeds this value. 4.1.5 Close Menu Selection of this button indicates that the menubar is to be closed after execution of a valid command. 4.1.6 Command Sets This list box displays the currently defined command sets. Each set is described in terms of the bitmap/icon file name, followed by the command file and parameters. Individual actions against command sets are at the bottom of the list box are discussed below. 4.1.6.1 ADD command This button activates the command set dialogue to create a new command entry following the currently selected entry in the list box. 4.1.6.2 MODIFY command This button activates the command set dialogue to modify the currently selected entry in the list box. 4.1.6.3 DELETE command This button deletes the currently selected entry in the list box. 4.1.6.4 CANCEL command This button exits the edit/create processing without changing the definition. 4.1.6.5 OK command This button exits the edit/create processing after changing the definition. 4.2 Command Set dialogue The command set dialogue contains fields to modify/create an individual command set consisting of a bitmap/icon file, a command file, and a set of parameters. Select buttons are provided to utilize the file open dialogues for selecting the files. 4.2.1 Bitmap/Icon file Entry to this edit box specifies the graphic file name to be displayed as the command identification on the menubar. This may be a standard windows icon (.ICO) or bitmap (.BMP) file. The SELECT button may be utilized to display the file selection dialogue for specifying the filename. 4.2.2 Command Entry to this edit box specifies the command to be executed by selection on the menubar. This may be any executable file that may be run under windows. The SELECT button may be utilized to display the file selection dialogue for specifying the filename. 4.2.3 Parameters Entry to this edit box is for specification of the parameters associated with the command to be executed. The shareware version only allows for specification as part of the menubar definition. 4.2.4 Select This button is utilized to display the file selection dialogue for specifying any filename. 4.3 File Select Dialogue This dialogue allows for selection of a file by browsing through directories and/or specification of portions of the filename. A default extension and prompt is provided for each type of file. 5.0 Mouse/key Usage The user may utilize either a mouse or the keyboard to execute commands, minimize the menubar or close the menubar. When using the mouse, three actions occur as a result of the mouse (left button) being clicked depending on the selection made. Selecting a bitmap/icon executes the command. Selecting the menubar border or any selection with the SHIFT key depressed closes the menubar. Any selection with the CONTROL key depressed minimizes the menubar. If the bar is minimized, a double click restores it to the original position. Alternately, the keyboard may be utilized. The ARROW keys are utilized to select individual command sets. Entry of a SPACEBAR or ENTER key executes the selected command. The ESCAPE key terminates the menubar. III. REGISTRATION AND LICENSE FEES MENUBAR must be registered if utilized for other than evaluation purposes for a period not to exceed thirty (30) days. A separate copy is required for each PC utilized. The file menubar.frm provides a sample form to be printed and included with payment or send your name, company, and address to MRL, 1200 Stonehurst Drive, Huntsville, Al, 35801. Registration using VISA/MC may also be accomplished by transmitting this form using Compuserve electronic mail to MRL at user id [73637,737]. Registration provides you with a version that includes the following: - No startup or periodic messages - Hardcopy users manual - Additional program features including user parameter input at execution. - 90 day free consultation support - Mailing list distribution of upgrades and new products ***************************************************************** This program has been developed and tested for Windows 3.0. Although Windows 3.1 is widely distributed, testing of MENUBAR on 3.1 has not been accomplished as of March 1, 1992. Should an update be required to execute under Windows 3.1 all registered users will receive this update free of charge. Delivery is dependent on availability of 3.1 software developers kit. ***************************************************************** 1. Registration Costs Current rates for prepaid orders (in US dollars) are as follows: $24.95 Single user registration/license fee. $1.00 Additional cost for 3.5 disk. $5.00 Per Order Shipping and Handling fee. $3.00 MC/VISA usage handling fee. $10.00 Purchase Order Handling (under $100.). Subject to Company approval. Residents of Alabama and Huntsville must add appropriate Sales Tax. The scheduled rates and charges are current as of the date of this manual. All fees and charges are subject to change without notice. Multiple Purchase registrations are available pursuant to the following schedules. Total Copies Registered (on one order) Percent Discount ------------ ------------ 1 to 5 0% 6 to 10 15% 10 to 99 30% 100 to 499 40% 500 to 999 50% 1000 or more 60% As stated herein, there are no warranties whatsoever associated with the MENUBAR software product, and MRL is not responsible for its performance. You are the sole judge of the product's effectiveness and suitability for your particular purposes, and are given an opportunity to evaluate same via shareware distribution. We can only accept drafts, checks, international money orders or travelers checks payable in U. S. dollars drawn on U.S. banks. Registration can also be paid by credit card, Visa or Master Card. Registered users will be notified when updates and new products are available. Anyone wishing to offer advice and suggestions are most welcome to do so. Questions, errors, and suggestions for product improvements are welcome, either mail these to MRL, 1200 Stonehurst Drive, Huntsville, AL, 35801 or transmit them via Compuserve electronic mail to MRL at user id [73637,737]. Compuserve electronic mail is the quickest method of receiving response. Be sure to include: - The version of the copy of MENUBAR that you are using. - DOS and Windows versions that you are using; - hardware configuration (model, memory size, printer, etc.) - Windows or standard DOS applications that you may be running or have loaded under Windows at the same time.